home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / lstrun17.zip / LASTRUN.DOC < prev    next >
Text File  |  1992-02-01  |  11KB  |  255 lines
  1.                           ┌─────────────┐
  2.                           │ LASTRUN.EXE │
  3.                           └─────────────┘
  4.                                  
  5.                       Last Mail Run Bulletin
  6.                             Tom Kellen
  7.                    ßETATech Computer Consulting
  8.  
  9. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  10.  
  11. PURPOSE:  This simple utility will create both mono and color
  12.           bulletins with your BBS name and the date and time of the
  13.           last successful PCRelay, FireNet, CircuitNET or other
  14.           network Mail Run.  It will make this bulletin with the
  15.           information on up to 8 different networks.  This program
  16.           should work with any BBS software as you specify the file
  17.           name of the bulletins.
  18.  
  19.  
  20.  
  21. INTRODUCTION:
  22.  
  23. The PCRelay software creates a one line text file listing the date and
  24. time of the last SUCCESSFUL mail import it does.  This is a nice
  25. feature, but I wanted a way to make a nice bulletin so that my user's
  26. would know exactly how current the RIME messages on board were.  Hence
  27. the birth of LASTRUN.EXE.  LASTRUN will create a monochrome and a
  28. color bulletin with the file names you supply it.  This bulletin will
  29. have your BBS name and the Date and Time of the last successful
  30. PCRelay import.  If you are connected to several different networks
  31. and are using PCRelay for all of them, it will create this bulletin
  32. showing the information on one to eight different networks.
  33.  
  34. Starting with version 1.4 I am adding support for CircuitNET. 
  35. Unfortunately CircuitNET does not create a LASTTIME.TXT type file upon
  36. successful import.  I hope the author will consider adding this in the
  37. future.  Many Spitfire sysops running CircuitNET are using a utility
  38. called STAMPER.  This creates a file very similar to LASTTIME.TXT. 
  39. The only problem with this method is that this file will be created
  40. each time the batch file that does the CircuitNET Mail Run is used,
  41. whether the run is successful or not.  Be that as it may, I have added
  42. support for reading STAMPER files or for having LASTRUN create the
  43. bulletin using the current date and time.
  44.  
  45. Included in the LastRun distribution ZIP should also be a file called
  46. LTFAKE.EXE.  This program creates a clone of the LASTTIME.TXT file
  47. created by PCRelay.  It will create this clone LASTTIME.TXT in the
  48. current directory or you can specify the directory it should use on
  49. the command line.  LTFake will use the current date and time in this
  50. file.  This program can be used in your FireNet or other network batch
  51. files to create a fake LASTTIME.TXT when you've had a mail run.  To
  52. make this more accurate, I would suggest using a command like:
  53. IF EXIST PARADIGM.FN LTFAKE
  54.  
  55. This would ensure that LTFake is only run on a successful mail run.
  56.  
  57.  
  58.  
  59. INSTALLATION:
  60.  
  61. Installation of LASTRUN is very simple.  Place LASTRUN.EXE in your
  62. PCRelay directory where all your node files are.  LASTRUN.EXE needs
  63. a configuration file called LASTRUN.CFG to also be in this directory. 
  64. I have included a sample one in the ZIP that you can edit to add the
  65. specifics for your BBS.
  66.  
  67. This configuration file should be created with an ASCII editor (like
  68. QEdit).  The first line is your BBS's name.  This can be up to 40
  69. characters long and will show up on the first line of the bulletin. 
  70. The second line is the full file specification for the mono bulletin. 
  71. The third line is the full file specification of the color bulletin. 
  72. Line 4 is for Spitfire BBS and if there is a Y on this line, LASTRUN
  73. will disable the MORE prompt by placing a ^B on the first line of the
  74. bulletins.  If you put an N on this line the ^B will not be placed in
  75. the bulletin.  SysOps of other BBS types, if ^B is not the same code
  76. for disabling MORE on your BBS place a N on line 4.  Line 5 is also
  77. for Spitfire BBS.  Putting a Y on this line will reenable the MORE
  78. prompt and force a MORE by placing a ^E and then a ^P on the last line
  79. of the bulletins.  Putting a N on line 5 will omit these codes from
  80. the bulletin.  You must not have any blank lines in the LASTRUN.CFG
  81. file until the last line or it will not read the rest of the
  82. configuration file, so put a Y or an N on these lines.  Line 6 is the
  83. name of the first network.  Network names can be up to 30 character's
  84. long.  Line 5 is the directory where LASTRUN will find the
  85. LASTTIME.TXT file for that particular network.  The next 14 lines if
  86. you have them alternate between the network name and the directory
  87. specification for that network's PCRelay files.
  88.  
  89. Here is sample LASTRUN.CFG:
  90.  
  91. The Paradigm BBS
  92. C:\SF\DISPLAY\ALL.BBS
  93. C:\SF\DISPLAY\ALL.CLR
  94. Y
  95. Y
  96. RIME
  97. C:\PCRELAY1
  98. LOCALNET T
  99. C:\RELAY2
  100. CIRCUITNET S
  101. C:\SF\CN3
  102.  
  103. There are 2 extra options in use in the above configuration file.  You
  104. will notice that there is a T after the LOCALNET name.  This tells
  105. LASTRUN to use the current Date and Time for this network.  This
  106. option get's the system Date and Time and so does not need to read any
  107. file.  However you MUST put something on the next line where a
  108. directory specification would normally go.  It can be any character,
  109. LASTRUN does nothing with it but it keeps LASTRUN from thinking this
  110. is the last line of the configuration file.
  111.  
  112. The other option you will notice is the S on the line after the
  113. CIRCUITNET name.  This tells LASTRUN that it will be reading a text
  114. file from STAMPER.  You must tell STAMPER to create the bulletins with
  115. the name of LASTTIME.  A sample STAMPER command line would be:
  116.  
  117. STAMPER C:\SF\CN3\LASTTIME
  118.  
  119. This will have STAMPER make LASTTIME.BBS and LASTTIME.CLR in the
  120. C:\SF\CN3 directory.  Lastrun will read the LASTTIME.BBS file to get
  121. the date and time.
  122.  
  123. One of the advantages of using STAMPER is that you can put it in your
  124. batch file for the CircuitNET Mail Run and it will create the text
  125. file with the date and time that batch file was run.  If you are
  126. running multiple networks you can then have LASTRUN as part of all
  127. your net-mail batch files and it will create the bulletins with all
  128. the actual times of the mail runs.  If you are only running CircuitNET
  129. and no other networks, you can use LASTRUN with the T option on the
  130. network name line and bypass using STAMPER.
  131.  
  132. Next you will need to edit the batch file that does your PCRelay mail
  133. import and add a line calling LASTRUN right after the line that call's
  134. IMPORT.  This will assure you that the bulletin is created with the
  135. most up to date information.  Here is an example of my PCRelay mail
  136. run batch file.
  137.  
  138. :EVENT_H
  139. REM RIME Network Mail Run
  140. CD\PCR
  141. EXPORT
  142. CD\TC
  143. TELIX SMAILRUN
  144. CD\PCR
  145. IMPORT
  146. LASTRUN                   
  147. CD\SF
  148.  
  149. That is all there is to it.  IMPORT creates the LASTTIME.TXT file in
  150. the PCRelay subdirectory with the date and time of the last successful
  151. message import.  LASTRUN.EXE reads this file and creates a bulletin
  152. that looks like this:
  153.               ╒═══════════════════════════════════════════════╕
  154.             █ │              The Paradigm BBS's               │
  155.             █ │                                               │
  156.             █ │              Last Successful RIME             │ 
  157.             █ │        Transfer Was At 21:01 On 02-01-92.     │
  158.             █ │                                               │ 
  159.             █ │             Last Successful INTELEC           │ 
  160.             █ │        Transfer Was At 21:02 On 02-02-92.     │ 
  161.             █ │                                               │ 
  162.             █ │            Last Successful LOCALNET           │ 
  163.             █ │        Transfer Was At 21:03 On 02-03-92.     │ 
  164.             █ │                                               │
  165.             █ │           Last Successful CIRCUITNET          │ 
  166.             █ │        Transfer Was At 21:04 On 02-03-92.     │ 
  167.             █ ╘═══════════════════════════════════════════════╛
  168.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  169.  
  170. The size of the bulletin varies with the number of networks you run.
  171.  
  172.  
  173.  
  174. OPERATION:
  175.  
  176. If you have placed the call to LASTRUN into your PCRelay batch file,
  177. operation is totally automatic, and the bulletins will be updated
  178. every time you do a mail transfer.
  179.  
  180.  
  181.  
  182. EPILOGUE:
  183.  
  184. This utility is being distributed under the Shareware principal.  This
  185. means you get to try this utility before your buy it.  If it is useful
  186. to you, pay the author for it, otherwise, delete it.  I am trying to
  187. create quality, low cost software so any and all contributions are
  188. welcome.  Send what you feel the utility is worth to the address below
  189. (suggested registration is one dollar).  Thanks for supporting
  190. Shareware and keeping this type of distribution alive.
  191.  
  192.  
  193.  
  194. AUTHOR CONTACT:
  195.  
  196. Problems, solutions, kudos and ideas are welcomed.  I can be reached
  197. at the following:
  198.  
  199. The Paradigm BBS                   ßETATech Computer Consulting
  200. 404/671-1581                       P. O. Box 566742
  201. 1200-19,200 Baud 24 Hrs/Day        Atlanta, GA  31156-6013
  202.  
  203.  
  204.  
  205. DISCLAIMER:
  206.  
  207. Use of this program acknowledges this disclaimer of warranty: "This
  208. program is supplied as is.  ßETATech Computer Consulting disclaims all
  209. warranties, express or implied, including, without limitation, the
  210. warranties of merchantability and of fitness of this program for any
  211. purpose.  ßETATech Computer Consulting assumes no liability for
  212. damages direct or consequential, which may result from the use of this
  213. program."
  214.  
  215.  
  216.  
  217. ACKNOWLEDGMENTS:
  218.  
  219. My thanks to Mike Woltz for his fine Spitfire BBS Software and for
  220. providing sample Turbo Pascal source code for us novice programmers. 
  221. This program uses Buffalo Creek's BCShare Turbo Pascal File Locking
  222. and Sharing routines.  Thanks to John Newlin for being my mentor and
  223. for being an inspirational programmer and providing excellent
  224. shareware to the computing public, and to Sammy Mitchell for his
  225. superb QEdit text editor, how can anyone do without it?
  226.  
  227.  
  228.  
  229. REVISION HISTORY:
  230.  
  231. 23-AUG-1990    v1.0      Initial Release.
  232.  
  233. 17-SEP-1990    v1.1      Added support for up to 4 different
  234.                          networks.
  235.  
  236. 20-SEP-1990    v1.11     Minor fix to screen info.
  237.  
  238. 27-SEP-1990    v1.2      Added support for up to 8 different
  239.                          networks.
  240.  
  241. 29-SEP-1990    v1.3      Fixed Bug in reading 5-8 LASTTIME.TXT
  242.  
  243. 04-OCT-1990    v1.4      Added support for CircuitNET & STAMPER.
  244.  
  245. 11-NOV-1990    v1.5      Added Spitfire MORE display control codes.
  246.  
  247. 18-NOV-1990    v1.51     Recompiled with BCShare v0.7 to correct some
  248.                          error checking.
  249.  
  250. 01-DEC-1990    v1.6      Recompiled with Turbo Pascal v6.0.
  251.  
  252. 01-FEB-1992    v1.7      Changed the way the control characters are
  253.                          entered in the bulletins to work better with
  254.                          Spitfire 3.2.  Added LTFAKE.EXE utility.
  255.